home *** CD-ROM | disk | FTP | other *** search
/ Archive Magazine CD 1995 / Archive Magazine CD 1995.iso / discs / prog_disc / volume_8 / issue_12 / whitworth / !KeyUtils / !Help next >
Encoding:
Text File  |  1995-07-18  |  6.2 KB  |  212 lines
  1. !KeyUtils v1.21 (RISC OS 3 and above only)
  2. ---------
  3.  
  4. By C Whitworth (c) Fractal Bonsai Software 1994/1995
  5. ----------------------------------------------------
  6.  
  7. Notice -
  8. --------
  9.  
  10. This application is FREEWARE. This means that it may be copied freely, as
  11. long as -
  12. • No charge above media and distribution costs is made,
  13. • It is not altered in any way, and the whole application is copied,
  14. • The further restrictions under the section  'Distribution' are adhered to.
  15.  
  16. The copyright remains mine (Chris Whitworth) at all times.
  17.  
  18. PD Libraries - if you wish to distribute this software, I will be happy to
  19. let you. However, I would be grateful if you would contact me first (at the
  20. address at the end of this file). This is so I know who is distributing my
  21. software, and so that I can ensure that the latest version is always in the
  22. catalogue.
  23.  
  24. Programmers - if you wish to use this utility in any other program, then
  25. contact me first, including _full_ details of what you want to do with it. If
  26. it inspires you to write any other program, but you do not actually use any
  27. of my code, a credit would be nice!
  28.  
  29. Please note - I (Chris Whitworth) am _Not_ responsible for any damage, loss
  30. of data, or other harmful effect caused by use or misuse of this application,
  31. and I am not prepared to reimburse any losses incurred by its use or misuse.
  32. Also, I do not make any warranty, whether express or implied, as to the
  33. program's fitness for any purpose.
  34.  
  35.  
  36.  
  37. What?
  38. -----
  39.  
  40. This application provides a means to use keyboard shortcuts to -
  41.  
  42. • Run applications (Ctrl+Alt+A)
  43. • Create new documents (Ctrl+Alt+D)
  44. • Change mode (Ctrl+Alt+M)
  45. • Execute any other *command
  46. • Move the mouse (Alt+Cursors)
  47.  
  48. Also, it provides an option to scan through the memory every ten seconds, and
  49. kill any loaded CheatMods (ie. Modules made by The Hacker)
  50.  
  51.  
  52. How? (said the Injun)
  53. ----
  54.  
  55. Before you use the application, you need to set up the status file, as
  56. described in the section below - 'Setting up'
  57.  
  58. To run an application, press Ctrl+Alt+A, followed by the defined key for the 
  59. application.
  60.  
  61. To create a new document, press Ctrl+Alt+D, followed by the defined key for
  62. that document.
  63.  
  64. To change mode, press Ctrl+Alt+M, followed by the mode definition number (eg.
  65. 1)
  66.  
  67. To use a *command, press Ctrl+Alt+defined key.
  68.  
  69. To move the pointer, press Alt+Cursor keys.
  70.  
  71.  
  72. Setting up
  73. ----------
  74.  
  75. As supplied, the application only has a few commands stored (see
  76. 'Distribution').
  77.  
  78. All the keypresses are stored in the 'Status' file in the application
  79. directory. The structure is as follows -
  80.  
  81. • Y/N (Kill/Don't kill CheatMods)
  82. • Number of 'application commands'
  83. • For each application -
  84.   • Keypress
  85.     (eg. E)
  86.   • Pathname of application
  87.     (eg. Resources:$.Apps.!Edit)
  88. • Number of document commands
  89. • For each application -
  90.   • Keypress
  91.     (eg. T)
  92.   • Empty document name (see below)
  93.     (eg. Text)
  94. • Number of *commands
  95. • For each command -
  96.   • Negative inkey value
  97.     (eg. 55 - O)
  98.   • Command
  99.     (eg. Filer_Boot ADFS::MyDisc.$.!System)¹
  100. • Number of modes
  101. • Mode list
  102.  
  103. ¹ If you want to open the floppy in drive 0, use the command OpenFloppyRoot.
  104. This isn't actually a real *command, but what it does is read the name of the
  105. disc in drive 0, and open this instead of ADFS::0.$.
  106.  
  107. Note on documents
  108. -----------------
  109. For the new document feature to work, an empty document of the appropriate
  110. type should be saved into !KeyUtils with the same name as the one in
  111. the Status file (note, same name, not pathname), but with a '•' (char 143)
  112. before the name. (eg. •Draw if the name is Draw)
  113.  
  114. So, for example-
  115.  
  116. File                        Meaning
  117.  
  118. N                         - Don't kill CheatMod's
  119. 1                         - 1 application
  120. E                         - Keypress E
  121. Resources:$.Apps.!Edit    - pathname for !Edit
  122. 1                         - 1 document
  123. T                         - Keypress T
  124. Text                      - Empty document is !KeyUtils.•Text 
  125. 1                         - *command
  126. 55                        - Inkey number
  127. Filer_OpenDir ADFS::0.$   - Open ADFS::0.$
  128. 2                         - 2 modes
  129. 35                        - Mode '1'
  130. 36                        - Mode '2'
  131.                           - Must end with a CR!
  132.  
  133. The program 'Inkey' when run waits for a key to be pressed. It then gives you
  134. the appropraite -ve inkey number.
  135.  
  136. The program 'Lock' locks the machine using a user defined password. The
  137. machine is then locked until 1) The correct password is given (hold down
  138. Space for 2 seconds, then type the password at the prompt) or 2) The machine
  139. is reset. Crude, but effective.
  140.  
  141.  
  142. Distribution
  143. ------------
  144.  
  145. If you pass a copy of this program on to someone else, copy the file
  146. Status_Bak as Status. This is the default status file, which does the
  147. following:
  148.  
  149. Don't kill CheatMods
  150.  
  151. Apps:
  152. E - Edit
  153. D - Draw
  154. P - Paint
  155.  
  156. Documents (note, these files should be present in !KeyUtils.docs)
  157. T - Text 
  158. D - Draw
  159.  
  160. Commands:
  161. L - Lock
  162. O - Open ADFS::0.$
  163. P - Open CFS#ADFS::0.$
  164.  
  165. Modes:
  166. 12,15,35,36,20,21
  167.  
  168.  
  169. Contact me at -
  170. -------------
  171.  
  172. Fractal Bonsai Software
  173.  c/o Chris Whitworth
  174.   Rufford House
  175.    Wymondham Road
  176.     Wreningham
  177.      Norfolk
  178.       NR16 1AT
  179.  
  180. Phone - (01508) 488204 after 6pm weekdays
  181.  
  182. Watch out for other Fractal Bonsai Software products
  183. =--------------------------------------------------=
  184.  
  185. Out now...
  186.  
  187. !TheFind   - Sort of like LeTrouve, but with better
  188.              graphics and the most annoying tune
  189.              ever.
  190. !Quadra    - Another puzzle game, very similar to
  191.              The Find (ie. Grafix and Sonix wise).
  192.              Very difficult, very playable!
  193. !Skaled    - A version of the classic Mac game,
  194.              Daleks, with nice graphics and silly
  195.              sound effects. (Sonic Screwdriver yet
  196.              to be implemented)
  197. !Toaster   - Talkie the Toaster!!! (Red Dwarf)
  198.  
  199. Coming soon...
  200.  
  201. !Diamonds  - A version of the Mac game, Diamonds. 
  202.              So addictive it should carry a Gov. Health
  203.              warning. If I can rip the music, it'll
  204.              have cool music fx too.
  205. !Stereo3D  - A suite of programs for making your own
  206.              3D stereograms to go all squiffy eyed at.
  207.              (will possibly also include DKBTrace, a
  208.              ray tracer that I didn't write and take
  209.              absolutely no credit for. I just happen to
  210.              like it, and use it for creating 3D
  211.              Stereogram image files)
  212.